home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / tcltk.z / tcltk / man / catn / seek.n < prev    next >
Text File  |  1994-09-20  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. seek(n)               Tcl Built-In Commands
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NAME
  11.      seek - Change the access position for an open file
  12.  
  13. SYNOPSIS
  14.      seek _f_i_l_e_I_d _o_f_f_s_e_t ?_o_r_i_g_i_n?
  15. _________________________________________________________________
  16.  
  17.  
  18. DESCRIPTION
  19.      Change the current access position for _f_i_l_e_I_d.  _F_i_l_e_I_d  must
  20.      have  been the return value from a previous call to open, or
  21.      it may be stdin, stdout, or stderr to refer to  one  of  the
  22.      standard  I/O  channels.   The  _o_f_f_s_e_t  and _o_r_i_g_i_n arguments
  23.      specify the position at which the next read  or  write  will
  24.      occur  for  _f_i_l_e_I_d.  _O_f_f_s_e_t must be an integer (which may be
  25.      negative) and _o_r_i_g_i_n must be one of the following:
  26.  
  27.      start
  28.           The new access position will be _o_f_f_s_e_t bytes  from  the
  29.           start of the file.
  30.  
  31.      current
  32.           The new access position will be _o_f_f_s_e_t bytes  from  the
  33.           current  access  position;  a negative _o_f_f_s_e_t moves the
  34.           access position backwards in the file.
  35.  
  36.      end  The new access position will be _o_f_f_s_e_t bytes  from  the
  37.           end  of  the file.  A negative _o_f_f_s_e_t places the access
  38.           position before the end-of-file, and a positive  _o_f_f_s_e_t
  39.           places the access position after the end-of-file.
  40.  
  41.      The _o_r_i_g_i_n argument defaults to start.  This command returns
  42.      an empty string.
  43.  
  44.  
  45. KEYWORDS
  46.      access position, file, seek
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Tcl                                                             1
  64.  
  65.  
  66.  
  67.